home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / gcc263-utildoc.lha / gnu / man / man1 / locate.1 < prev    next >
Encoding:
Text File  |  1994-12-19  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. LOCATE(1L)                                             LOCATE(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        locate - list files in databases that match a pattern
  9.  
  10. SSYYNNOOPPSSIISS
  11.        llooccaattee  [-d  path]  [--database=path] [--version] [--help]
  12.        pattern...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        This manual page documents the GNU version of llooccaattee.  For
  16.        each  given pattern, llooccaattee searches one or more databases
  17.        of file names and displays the file names that contain the
  18.        pattern.  Patterns can contain shell-style metacharacters:
  19.        `*', `?', and `[]'.  The metacharacters do not  treat  `/'
  20.        or  `.'   specially.   Therefore,  a pattern `foo*bar' can
  21.        match a file name that contains `foo3/bar', and a  pattern
  22.        `*duck*'   can   match   a   file   name   that   contains
  23.        `lake/.ducky'.   Patterns  that   contain   metacharacters
  24.        should  be  quoted  to  protect them from expansion by the
  25.        shell.
  26.  
  27.        If a pattern is a plain string -- it contains no metachar-
  28.        acters  --  llooccaattee displays all file names in the database
  29.        that contain that string anywhere.  If a pattern does con-
  30.        tain  metacharacters, llooccaattee only displays file names that
  31.        match the pattern exactly.  As  a  result,  patterns  that
  32.        contain  metacharacters  should  usually begin with a `*',
  33.        and will most often end with one as well.  The  exceptions
  34.        are  patterns  that  are  intended to explicitly match the
  35.        beginning or end of a file name.
  36.  
  37.        The file name databases contain lists of files  that  were
  38.        on  the  system when the databases were last updated.  The
  39.        system administrator can  choose  the  file  name  of  the
  40.        default  database,  the frequency with which the databases
  41.        are updated, and the directories for  which  they  contain
  42.        entries; see uuppddaatteeddbb(1L).
  43.  
  44. OOPPTTIIOONNSS
  45.        _-_d _p_a_t_h_, _-_-_d_a_t_a_b_a_s_e_=_p_a_t_h
  46.               Instead   of   searching   the  default  file  name
  47.               database, search the file name databases  in  _p_a_t_h,
  48.               which  is  a  colon-separated list of database file
  49.               names.  You can also use the  environment  variable
  50.               LLOOCCAATTEE__PPAATTHH  to  set  the list of database files to
  51.               search.  The option overrides the environment vari-
  52.               able if both are used.
  53.  
  54.        The  file  name  database format changed starting with GNU
  55.        ffiinndd and llooccaattee version 4.0 to allow machines with diffent
  56.        byte  orderings  to  share the databases.  This version of
  57.        llooccaattee can automatically recognize and read databases pro-
  58.        duced for older versions of GNU llooccaattee or Unix versions of
  59.        llooccaattee or ffiinndd.
  60.  
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LOCATE(1L)                                             LOCATE(1L)
  71.  
  72.  
  73.        _-_-_h_e_l_p Print a summary of the options to llooccaattee and  exit.
  74.  
  75.        _-_-_v_e_r_s_i_o_n
  76.               Print the version number of llooccaattee and exit.
  77.  
  78. EENNVVIIRROONNMMEENNTT
  79.        LLOOCCAATTEE__PPAATTHH
  80.               Colon-separated list of databases to search.
  81.  
  82. SSEEEE AALLSSOO
  83.        ffiinndd(1L),  llooccaatteeddbb(5L),  uuppddaatteeddbb(1L),  xxaarrggss(1L) FFiinnddiinngg
  84.        FFiilleess (on-line in Info, or printed)
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.